home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / qbbs / gbirth20.zip / GETBIRTH.DOC next >
Text File  |  1991-02-27  |  4KB  |  91 lines
  1.                               GetBirth 2.0
  2.             Copyright (c) 1991, Lost In Space Programming
  3.                            All Rights Reserved.
  4.  
  5.  
  6. Introduction.
  7.      GetBirth is a fairly simple program.  It has two major tasks.  It 
  8. will either get the birthdate of the user currently on-line or it will 
  9. check the birthdates of all the users in your USERS.BBS and USERSXI.BBS 
  10. files against an age and set and/or clear flags accordingly.  What 
  11. GetBirth does depends upon what you tell it on the command line.  In 
  12. this case, it will probably make the most sense if we just go ahead with 
  13. how to use it.
  14.  
  15. How to use GetBirth.
  16.      GetBirth accepts up to five command line parameters.  These may be 
  17. combined in order to accomodate the sysop.  These parameters are com 
  18. port (P#), global use (G), flag to set (flag), flag to clear (-flag), and 
  19. age to check against (age).  The port may be any port used with X00 or 
  20. BNU (GetBirth uses the fossil for all com I/O) and is specified with P# 
  21. on the command line ("GetBirth P2" means use COM2).  The global use 
  22. means for GetBirth to check each user's birthdate against an age (which 
  23. will be 18 if not specified).  It is specified as "GetBirth G".  The 
  24. flag to set (either as after the birthdate entry or for those old as age)
  25. is specified simply as A1 - A8, B1 - B8, C1 - C8, or D1 - D8.  Lower 
  26. case works fine also.  The flag to clear uses a "-" before the flag name 
  27. but otherwise is identical to the flag to set as far as specification 
  28. ("GetBirth G A8 -C2" will clear flag C2 and set flag A8 for each user 18
  29. years old or older, "GetBirth P1 B1 -D3" will use COM1, ask the user for 
  30. his/her birthdate, and clear flag D3 and set flag B1 when done.)  
  31. Finally, the age parameter is simply the number for the age you wish to 
  32. check against.  ("GetBirth G B1 -D3 21" will check each user for age 21
  33. and clear flag D3 and set flag B1 for each user that age or older).
  34.  
  35. Examples:
  36.         Running on-line, to add existing user's birthdate, running as
  37.         a type 7, com1:, and you have it so that C1 controls the
  38.         execution of this menu item:
  39.                 GETBIRTH.EXE P1 -C1
  40.  
  41.         Running on-line, you want to CLEAR C1, and set C2 when they run
  42.         this menu item:
  43.                 GETBIRTH.EXE P1 -C1 C2
  44.  
  45.         Running as a weekly event, to set the users who are adult, (say,
  46.         18), and you want all adults to have flag D1 turned on:
  47.                 GETBIRTH.EXE G D1 18
  48.  
  49.         Running as a weekly, you want to have a certain flag for those
  50.         between 14 and 18.  The adults (18 and older) already have flag
  51.         D1 set, and the 14-18 year olds will have flag D2 set.
  52.                 GETBIRTH.EXE G -D1 D2 14
  53.  
  54.         For Help:
  55.                 GETBIRTH.EXE ?
  56.  
  57.  
  58.         *note: 18 is the default age of adult within the program, so if
  59.         you do not enter an age, it will default to 18.
  60.  
  61. ***WARNING***   This has not been tested in the Global function in a
  62.                 Multi-Line setup... for safety, do not run while a
  63.                 seperate node is on-line, and accessing the USERS*.BBS
  64.                 files.
  65.  
  66. Registration.
  67.      To register GetBirth, simply send a check or money order for $5 (US 
  68.      currency) to:
  69.     Lost In Space Programming
  70.     3464 Mayflower Avenue
  71.     Memphis, TN 38122
  72. This will entitle you to future upgrades as soon as they come out which 
  73. will be sent to you at OUR COST!!!
  74.  
  75. Bug reports, comments.
  76.      If you have any comments, bug reports, or just want somebody to 
  77.      talk to, netmail or call Worthington's Computer, 1:123/5, (901)
  78.      458-3604.  We'll be happy to discuss GetBirth and other Lost In Space
  79.      Programming projects.
  80.     
  81. John Worthington, 1:123/5, Worthington's Computer - 9600 @ V32
  82. James Rhodes, 1:123/13.4, Shadow's Realm - Point System
  83. Kerry Buckingham, 1:123/22, Buckingham's Palace - 9600 HST
  84. (Lost In Space Programming)
  85.  
  86. Plans for next version:
  87.         Check age when run On-Line mode
  88.         ANSI Support On-Line
  89.         Group support during runtime (Set groups as well as flags)
  90.         and any other ideas you all come up with.
  91.